DisposeCIcon

DisposeCIcon
Header:	Icons.h		Carbon status:	Supported

Releases the memory occupied by a color icon structure.

void DisposeCIcon (
    CIconHandle theIcon
);

theIcon: A handle to the color icon structure to dispose of, previously obtained from the GetCIcon function.

DISCUSSION

The DisposeCIcon function is also available as the DisposCIcon function.

To dispose of a handle obtained from GetIcon or GetResource, use the ReleaseResource function to release the memory occupied by the icon resource data.

SPECIAL CONSIDERATIONS

This function may move or purge memory blocks in the application heap. For that reason, your application should not call it at interrupt time.

VERSION NOTES

This function is available in both System 6 and System 7.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.